home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3x / curs_refresh.z / curs_refresh
Encoding:
Text File  |  2002-10-03  |  8.3 KB  |  130 lines

  1.  
  2.  
  3.  
  4. ccccuuuurrrrssss____rrrreeeeffffrrrreeeesssshhhh((((3333XXXX))))                                              ccccuuuurrrrssss____rrrreeeeffffrrrreeeesssshhhh((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_rrrr_ssss______rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh:  _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh, _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh, _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh, _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee, _rrrr_eeee_dddd_rrrr_aaaa_wwww_wwww_iiii_nnnn,
  10.      _wwww_rrrr_eeee_dddd_rrrr_aaaa_wwww_llll_nnnn - refresh _cccc_uuuu_rrrr_ssss_eeee_ssss windows and lines
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>>
  14.  
  15.      _iiii_nnnn_tttt _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  16.      _iiii_nnnn_tttt _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_))))_;;;;
  17.      _iiii_nnnn_tttt _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_))))_;;;;
  18.      _iiii_nnnn_tttt _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  19.      _iiii_nnnn_tttt _rrrr_eeee_dddd_rrrr_aaaa_wwww_wwww_iiii_nnnn_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_))))_;;;;
  20.      _iiii_nnnn_tttt _wwww_rrrr_eeee_dddd_rrrr_aaaa_wwww_llll_nnnn_((((_WWWW_IIII_NNNN_DDDD_OOOO_WWWW _****_wwww_iiii_nnnn_,,,, _iiii_nnnn_tttt _bbbb_eeee_gggg______llll_iiii_nnnn_eeee_,,,, _iiii_nnnn_tttt _nnnn_uuuu_mmmm______llll_iiii_nnnn_eeee_ssss_))))_;;;;
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      The _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh and _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh routines (or _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh and _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee) must be
  24.      called to get any output on the terminal, as other routines merely
  25.      manipulate data structures.  The routine _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh copies the named window
  26.      to the physical terminal screen, taking into account what is already
  27.      there in order to do optimizations.  The _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh routine is the same,
  28.      using _ssss_tttt_dddd_ssss_cccc_rrrr as the default window.  Unless _llll_eeee_aaaa_vvvv_eeee_oooo_kkkk has been enabled, the
  29.      physical cursor of the terminal is left at the location of the cursor for
  30.      that window.
  31.  
  32.      The _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh and _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee routines allow multiple updates with more
  33.      efficiency than _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh alone.  In addition to all the window
  34.      structures, _cccc_uuuu_rrrr_ssss_eeee_ssss keeps two data structures representing the terminal
  35.      screen:  a physical screen, describing what is actually on the screen,
  36.      and a virtual screen, describing what the programmer wants to have on the
  37.      screen.
  38.  
  39.      The routine _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh works by first calling _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh, which copies
  40.      the named window to the virtual screen, and then calling _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee, which
  41.      compares the virtual screen to the physical screen and does the actual
  42.      update.  If the programmer wishes to output several windows at once, a
  43.      series of calls to _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh results in alternating calls to _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh
  44.      and _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee, causing several bursts of output to the screen.  By first
  45.      calling _wwww_nnnn_oooo_uuuu_tttt_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh for each window, it is then possible to call
  46.      _dddd_oooo_uuuu_pppp_dddd_aaaa_tttt_eeee once, resulting in only one burst of output, with fewer total
  47.      characters transmitted and less CPU time used.  If the _w_i_n argument to
  48.      _wwww_rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh is the global variable _cccc_uuuu_rrrr_ssss_cccc_rrrr, the screen is immediately cleared
  49.      and repainted from scratch.
  50.  
  51.      The _rrrr_eeee_dddd_rrrr_aaaa_wwww_wwww_iiii_nnnn routine indicates to _cccc_uuuu_rrrr_ssss_eeee_ssss that some screen lines are
  52.      corrupted and should be thrown away before anything is written over them.
  53.      These routines could be used for programs such as editors, which want a
  54.      command to redraw some part of the screen or the entire screen.  The
  55.      routine _rrrr_eeee_dddd_rrrr_aaaa_wwww_llll_nnnn is preferred over _rrrr_eeee_dddd_rrrr_aaaa_wwww_wwww_iiii_nnnn where a noisy communication
  56.      line exists and redrawing the entire window could be subject to even more
  57.      communication noise.  Just redrawing several lines offers the possibility
  58.  
  59.  
  60.                                                                         PPPPaaaaggggeeee 1111
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. ccccuuuurrrrssss____rrrreeeeffffrrrreeeesssshhhh((((3333XXXX))))                                              ccccuuuurrrrssss____rrrreeeeffffrrrreeeesssshhhh((((3333XXXX))))
  68.  
  69.  
  70.  
  71.      that they would show up unblemished.
  72.  
  73. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  74.      All routines return the integer _EEEE_RRRR_RRRR upon failure and an integer value
  75.      other than _EEEE_RRRR_RRRR upon successful completion.
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      The header file _<<<<_cccc_uuuu_rrrr_ssss_eeee_ssss_...._hhhh_>>>> automatically includes the header files
  79.      _<<<<_ssss_tttt_dddd_iiii_oooo_...._hhhh_>>>> and _<<<<_uuuu_nnnn_cccc_tttt_rrrr_llll_...._hhhh_>>>>.
  80.  
  81.      Note that _rrrr_eeee_ffff_rrrr_eeee_ssss_hhhh and _rrrr_eeee_dddd_rrrr_aaaa_wwww_wwww_iiii_nnnn may be macros.
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      _cccc_uuuu_rrrr_ssss_eeee_ssss(3X), _cccc_uuuu_rrrr_ssss______oooo_uuuu_tttt_oooo_pppp_tttt_ssss(3X)
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                                                         PPPPaaaaggggeeee 2222
  127.  
  128.  
  129.  
  130.